home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 2 / Amiga Tools 2.iso / wb-tools / screen-tools / palettetoolv1.4 / palettetool.guide (.txt) < prev    next >
Amigaguide Document  |  1995-03-09  |  28KB  |  537 lines
  1. @database PaletteTool.guide
  2. @node Main "PaletteTool" 
  3. PaletteTool - A Public Screen palette for 8 or more colors
  4. Copyright 
  5. 1994 by Timothy B. Kreuzer.  All rights reserved.
  6. Version: 1.4
  7. Author: Tim Kreuzer (and the KreuzerSoft support team)
  8. Language: SAC/C V6.5
  9.       @{"Features" link features}
  10.       @{"Limitations" link limitations}
  11.       @{"Release Notes" link releasenotes}
  12.       @{"Notes from the Author" link notesfromtheauthor}
  13.       @{"Why PaletteTool?" link whypalettetool}
  14.       @{"Terminology Disclaimer" link terminologydisclaimer}
  15.       @{"Starting PaletteTool" link startingpt}
  16.       @{"Main PaletteTool Window Description" link mainptwindowdescription}
  17.       @{"Palette Window Description" link palettewindowdescription}
  18.       @{"ColorByName Window Description" link cbnwindowdescription}
  19.       @{"Iconified Window Description" link iconwindowdescription}
  20.       @{"Basic PaletteTool Operation" link basicptoperation}
  21.       @{"Icon Tooltypes" link icontooltypes}
  22.       @{"Credits" link credits}
  23.       @{"Contacting the Author" link contactingtheauthor}
  24.       @{"Legal Stuff" link legalstuff}
  25.       @{"KreuzerSoft Products" link kreuzersoftproducts}
  26. @endnode
  27. @node features "Features"
  28.       Opens and operates on the default public screen
  29.       Gadtools-based user interface, with keyboard equivalents for
  30.        many of the program functions
  31.       Full 8 bit RGB support
  32.       Full AmigaDOS 3.0-compliant locked pen "protect" mode as well
  33.        as standard "free" mode
  34.       Fully integrated "color by name" selection, with a built-in
  35.        database of 507 colors
  36.       Supports the follow actions:
  37.          - color spread (multi-directional)
  38.          - individual color copy
  39.          - individual color exchange
  40.          - rotation of palette in both direction
  41.          - cycling of entire palette in both directions
  42.            with adjustable cycle speed
  43.          - individual color "show" (flash selected color)
  44.       User interface consists of separately controllable windows for:
  45.          - main functions
  46.          - color palette (2 sizes)
  47.          - "color by name" selection
  48.       Features a single-level "undo" capability
  49.       Iconifiable, with color cycling controls also available from
  50.        the programs iconified state
  51.       Features ability of pick a pen/color from anywhere on the
  52.        current screen (using the mouse pointer and either the space
  53.        bar or middle-mouse-button).  This type of color "pick" can
  54.        also be used with the copy, spread, and exchange actions
  55.       Freatures a "panic" restore button (and key equivalent) so
  56.        you can restore the palette to where it was at program start
  57.       "Smart" iconify function
  58.       Help text (displayed on screen banner) for the copy, spread,
  59.        exchange, and pick actions
  60.       Upon exit, restores palette to where it was at start-up
  61.       Single version for 68020 and up CPUs (all AGA Amigas)
  62.       Tested OK using the Enforcer
  63. @endnode
  64. @node limitations "Limitations"
  65.       Can only be used from the Workbench (start via Icon) 
  66.       Requires AmigaDOS 3.0(+) and the AGA chipset
  67.       Requires a 68020(+) CPU
  68.       Designed for use with higher-resolution screen modes (640x400 and
  69.        higher).  Note that this does NOT mean the program will not work
  70.        on lower-resolution screens.  What it DOES mean is that you may
  71.        find the programs windows take up a lot of screen "real estate"
  72.        on lower-resolution screens
  73.       For some reason, the "pick" capability (using the space bar and/or
  74.        middle-mouse-button) does not work correctly when using any of
  75.        the screen modes supplied by EGS Spectrum graphics boards.  I'm
  76.        guessing this is a problem with the EGS "Amiga screen" emulation
  77. @endnode
  78. @node releasenotes "Release Notes"
  79. -----------------
  80. Version 1.4 Notes
  81. -----------------
  82. Completed reworked the user interface:
  83.    - Moved the palette display to a separate window
  84.    - Palette window can be displayed in two (user selectable) sizes
  85.    - Added keyboard equivalents
  86.    - Palette cycling controls now available on the iconify window
  87.      as well as the main control window
  88. Added the (incremental) palette rotation capability
  89. Added the color exchange capability
  90. Added the keyboard equivalents
  91. Reworked major sections of the source code
  92. ------------------
  93. Version 1.3b Notes
  94. ------------------
  95. Fixed bug which caused inaccurate color "Spread" to occur while in the
  96. "Protect" palette mode
  97. ------------------
  98. Version 1.3a Notes
  99. ------------------
  100. Fixed bug which caused the 3 pointer colors to be skipped on a Spread
  101.  action in "Free" mode (would only see this on screens with 32 or more
  102.  pens).  I really apologize for this, as I am very picky about only 
  103.  uploading fully tested programs!
  104. -----------------
  105. Version 1.3 Notes
  106. -----------------
  107. Screens with a minimum of 8 colors now supported
  108. Added "color by name", "panic restore", "pick from screen", full 
  109.  AmigaDOS 3.0 palette "protect" mode, and "free" mode capabilities.
  110.  Note that "protect" mode takes the place of the old "hardcoded"
  111.  method of avoiding pens/colors used by the system
  112. Fixed bug in "Iconify", where the previous positions of the main PaletteTool
  113.  window and the inconified window were not restored when they (re)opened.
  114.  Windows were opening at a fixed location (yech!)
  115. The currently selected pen/color in the main palette display is now
  116.  recessed, allowing for easier visual confirmation
  117. Main palette gadget is no longer disabled during cycling
  118. Miscellaneous code and user interface cleanup
  119. -----------------
  120. Version 1.2 Notes
  121. -----------------
  122. Added full 8-bit RGB support (Hurray!)
  123. Added Iconify ("I" button) support
  124. Added About ("?" button)
  125. Added support for "X" and "Y" icon tooltypes to determine position
  126.  of PaletteTool window at startup
  127. Corrected the Spread function's math to allow "smoother" spreads
  128. PaletteTool will no longer open on a screen that supports less than
  129.  32 colors; a nice requester will pop up to remind you of this if you try
  130. Fixed problem where original palette was not correctly restored upon
  131.  quiting following certain types of Undo actions
  132. Fixed problem where the currently selected color's RGB slider values were
  133.  not correctly reset after an Undo action
  134. All other features operate the same as in version 1.1
  135. -----------------
  136. Version 1.1 Notes
  137. -----------------
  138. Added the Copy, Undo, and Spread capabilities
  139. Added the "restore palette at exit" capability
  140. All other features operate the same as in initial release version
  141. The loading and unloading of the palettes at the beginning and end of
  142. cycling can lock up your Amiga for 1 second or so
  143. DON'T PANIC IF THIS SHOULD HAPPEN!  OK?  Sorry for yelling!
  144. @endnode
  145. @node notesfromtheauthor "Notes from the Author"
  146. Upon release of V1.3 of PaletteTool, the program grew in size by about
  147. 100%.  The biggest reason for the size increase was the addition of
  148. the color-name database.  With this version (V1.4) I've managed to keep
  149. the program size roughly the same as before (approx 46K bytes) while
  150. adding a lot of new features. 
  151. I'd like the get the program "smaller" if possible, and will continue
  152. looking for ways to do this.
  153. I decided a few versions ago that separate executables for 68020/30/40 
  154. CPUs were really not needed, as the most "intensive" thing PaletteTool
  155. does is cycling.
  156. I really didn't want to use the "space bar" for the "pick" action, but I 
  157. don't know any other method (short of middle or right mouse button).
  158. I ran into weird system-lockup problems trying to trap an IDCMP window
  159. inactiviate (and update the gadgets) when the left mouse button was
  160. pressed outside the PaletteTool window.  I also didn't want to use the
  161. right mouse button because of their standard use with menus.
  162. The creation and evolution of PaletteTool has served as a wonderful
  163. introduction-to and expansion-of my learning more about both the "C"
  164. programming language and the Amiga.  It's a real joy developing code
  165. on such a wonderful machine (and operating system).
  166. @endnode
  167. @node whypalettetool "Why did I create PaletteTool?"
  168. 18 months ago, after deciding to take the plunge and buy an A4000 
  169. (which, by the way, is a fantastic machine!), I was disappointed in
  170. the lack of applications which exploited the increased color capabilities
  171. of 3.0/AGA.  I went about creating some simple, yet fun, graphics
  172. programs with would exploit the color modes above 16 (see my Fractal,
  173. Lyapunov Space, and Terrain uploads).
  174. Then I realized that these graphics programs needed some type of palette 
  175. control.
  176. This need resulted in the creation of PaletteTool, the latest version
  177. of which you are now reading about.
  178. I decided that is was much better to implement the palette control for 
  179. these applications as a separate utility, rather than embed it within
  180. each program.  That way, the palette control could be used along with
  181. any program which operates on a (default-able) public screen (like
  182. the Workbench).
  183. NOTE that PaletteTool can be used to alter the color palette of ANY
  184. Workbench or default Public Screen which supports at least 8 colors.
  185. It's functioning is NOT in any way dependant upon the presence of my 
  186. Fractal, Lyapunov Space, or Terrain programs.
  187. Regarding the "color by name" facility:  I don't know about you, but
  188. I am terrible at trying to "roll my own" colors using RGB sliders!
  189. @endnode
  190. @node terminologydisclaimer "Terminology Disclaimer"
  191. I have a bad tendency to use the terms "color", "pen", and "register"
  192. somewhat interchangably.
  193. From this point forward, I will be adopting the following:
  194.    "Pen" - Will be used to denote one of the physical "slots" which can
  195.            can hold a single set of RGB values.
  196.            For example, if you have an 8 color screen, you actually have
  197.            8 pens available.  Each of these pens can hold a different
  198.            color.
  199.    "Color" - Will be used to denote a distinct set of RGB values, which
  200.              may also have a name at times (like "light blue").
  201.    "Register" - The same as "Pen" in my book.  I will try and use "Pen",
  202.                 however, as Commodore uses this term.
  203. @endnode
  204. @node startingpt "Starting PaletteTool"
  205. Just click on the PaletteTool icon.  PaletteTool will detect the number
  206. of pens available on the default Public Screen, and open it's window on
  207. this screen.  Note that the Workbench screen is the standard default
  208. Public Screen.
  209. My PST (Public Screen Tool) program can be used to open a Public Screen
  210. at any AmigaDOS 2.04(+) supported resolution and depth.  This includes
  211. any graphics boards which add entries to the Amiga's display database
  212. (like the EGS Spectrum). 
  213. PST is available on many fine BBS's.
  214. I strongly recommend you get (and use!) PST if you are interested in
  215. running programs (like my Palette/LyapunovSpace/Terrain programs) on
  216. public screens other than the Workbench.  Like PaletteTool, PST is in
  217. no way dependant/tied-into my other programs.  It is a full, stand-alone
  218. utility in it's own right.
  219. @endnode
  220. @node mainptwindowdescription "Main PaletteTool Window Description"
  221. The main PaletteTool window consists of the following items:
  222.  1) Palette @{"Closed/Open" beep 0} @{"Sm/Lg" beep 0}
  223.     Key equivalent is either "p" or "P".
  224.     The "Closed/Open" cycle gadget controls the opening/closing of
  225.     the window containing the actual screen palette.
  226.     The "Sm/Lg" cycle gadget controls the size of the window containing
  227.     the actual screen palette.
  228.     Within this separate window, you can optionally select (using the
  229.     pointer and the left-mouse-button):
  230.        - the pen to be modified by the Red/Grn/Blu sliders
  231.        - the pens associated with copy, spread, and exchange actions.
  232.        - the pen whose color is to be "flashed" by the "Show" button
  233.     The currently selected pen is recessed within the palette gadget.
  234.  2) ColorByName @{"Closed/Open" beep 0}
  235.     Key equivalent is either "n" or "N".
  236.     The "Closed/Open" cycle gadget controls the opening/closing of
  237.     the window containing the "color by name" database.
  238.     This ColorByName window is where you can choose RGB values for
  239.     the currently selected pen by simply left-clicking on one of the
  240.     names in the scrolling list.
  241.     The ColorByName window can be positioned independently of the main
  242.     PaletteTool window.  The location of the ColorByName window will also
  243.     be restored upon un-iconifying.
  244.     However, when the ColorByName window is closed using the "ColorByName"
  245.     button, it will re-open immediately adjacent to the main PaletteTool
  246.     window.
  247.  3) A box which displays the color of the currently selected pen (on 
  248.     the middle-right side of the window).
  249.  4) @{"Red" beep 0} @{"Grn" beep 0} @{"Blu" beep 0} Sliders
  250.     Three color modification sliders, one each for the Red (Red),
  251.     Green (Grn), and Blue (Blu) color components.
  252.     These affect the color of the currently selected pen.
  253.  5) @{"Copy" beep 0} Button
  254.     Key equivalent is either "c" or "C".
  255.     Allows the copying of one pen's color into another pen.
  256.     To perform a copy:
  257.     - first select the pen whose color is to be copied
  258.         - hit the "Copy" button
  259.         - then select the pen where that color should be copied-to
  260.     NOTE that you can either pick the copy-to color from the Palette
  261.     window >> OR << use the "Pick" button to select the copy-to color
  262.     from anywhere on the screen.
  263.  5) @{"Sprd" beep 0} Button
  264.     Key equivalent is either "s" or "S".
  265.     Allows spreads (gradients) between the colors of two selected pens.
  266.     To perform a "spread":
  267.     - first select the starting pen
  268.         - hit the "Sprd" button
  269.         - then select the ending pen
  270.     The colors of each intermediate pen will then be changed to a smooth 
  271.     gradient between the staring and ending pen colors.
  272.     NOTE that you can either pick the spread-to color from the Palette
  273.     window >> OR << use the "Pick" button to select the spread-to color
  274.     from anywhere on the screen.
  275.  6) @{"Excg" beep 0} Button
  276.     Key equivalent is either "x" or "X".
  277.     Allows the exchange of one pen's color with another pen's color.
  278.     To perform an "exchange":
  279.     - first select the starting pen
  280.         - hit the "Excg" button
  281.         - then select the containing the color you wish exchanged with
  282.           the previously selected pen
  283.     NOTE that you can either pick the exchange-with color from the 
  284.     Palette window >> OR << use the "Pick" button to select the
  285.     exchange-with color from anywhere on the screen.
  286.  7) @{"Undo" beep 0} Button
  287.     Key equivalent is either "u" or "U".
  288.     Restores the palette pen colors to how they were prior to the
  289.     immediately previous color action (Copy/Spread/Exchange).
  290.     Note that I said "how they were prior to the immediately previous
  291.     action".  Don't get confused and think that the program is acting
  292.     up when you do an Undo, and some individual pen color mods you have
  293.     made since the last Copy/Sprd/Excg get wiped out!
  294.     IMPORTANT - Repeatedly selecting Undo will toggle the palette between
  295.                 where it was (before the last Copy/Spread/Exchange) and
  296.                 where it is (before you selected Undo).  Try this to get
  297.                 a better (or any) sense of what I'm trying to explain ;v).
  298.  8) @{"Protect/Free" beep 0} Cycle Gadget
  299.     "Protect" means that PaletteTool will pay special attention to those
  300.     pens which it determined were locked at the time PaletteTool was
  301.     started.  A pen can be locked by any 3.0-aware program (like AmigaDOS).
  302.     Examples of locked pens would be those used to render the Intuition
  303.     windows, menus, and gadgets (background/borders/text/buttons/etc.)
  304.     What "Protect" means to you is that:
  305.       - You will be unable to select a locked pen from the palette gadget
  306.       - The spread action will "skip over" the colors in any locked pen
  307.       - The cycle action will "skip over" any locked pen
  308.       - The "Pick" function will not select a locked pen, even when the
  309.         screen color you pick is contained in one of the locked pens
  310.     "Free" means that PaletteTool will not pay ANY attention to locked
  311.     pens.  This mode is what you are probably used to in all the other
  312.     palette programs you are using.
  313.     What "Free" means to you is that:
  314.       - You will be unable to select any pen from the palette gadget
  315.       - The spread action will affect the color of EVERY "in between" pen
  316.       - The cycle action will cycle EVERY pen's color
  317.       - The "Pick" function will always result in the selection of a pen
  318.     Obviously, CARE MUST BE EXERCISED while in "Free" mode, or you can
  319.     quickly hose things up (i.e., end up with an unreadable screen).
  320.     That's why I added the "panic reset" button ("Reset") with it's "R"
  321.     key equivalent.  You can always reset the screen palette to where it
  322.     was at PaletteTool startup by either:
  323.       - Selecting the "Reset" button   >>OR<<
  324.       - Pressing the "R" key on your keyboard
  325.     At startup, PaletteTool attempts to set the palette mode to "Protect".
  326.     If, however, it finds that ALL the screen's pens are locked, it opens
  327.     in "Free" mode.  When this occurs, the "Protect/Free" cycle gadget is
  328.     disabled.
  329.  9) @{"Show" beep 0} Button
  330.     Key equivalent is either "h" or "H".
  331.     Flashes the color of the currently selected pen.
  332.     This comes in handy if you are looking at a screen with a lot of
  333.     similar (or just a lot of) colors, and are curious as to which
  334.     pen is responsible for that color.
  335. 10) @{"Pick" beep 0} Button
  336.     Key equivalent is either "i" or "I".
  337.     Allows you to select a pen by picking any color on the current 
  338.     screen via the mouse pointer.
  339.     To use, first select the "Pick" button.
  340.     Some (hopefully) descriptive text will then be displayed in the
  341.     current screens banner (at the top of the screen), and the "Pick"
  342.     button will disable, reminding you that you're doing a "Pick".
  343.     Move the mouse pointer (anywhere on the screen), until it is over
  344.     the desired color.
  345.     DO NOT PRESS THE LEFT MOUSE BUTTON WHILE YOU'RE "PICK"ING - one of
  346.     the displayed PaletteTool windows (main/palette/colorbyname) must
  347.     be active when you're doing your "pick".
  348.     To select the pen associated with this color, either:
  349.        - Press the space bar on your keyboard  >>OR<<
  350.        - Press the middle button on your mouse (if you have 3 button mouse)
  351.     The reason I asked you not to press the left mouse button during the
  352.     "Pick", is that either the PaletteTool or ColorByName windows must
  353.     be active for the "Pick" to work.
  354.     If you're having problems with "Pick":
  355.        - Make sure either the PaletteTool, Palette, or ColorByName windows
  356.          are active by left-clicking on either window border
  357.        - Don't forget that in "Locked" mode, PaletteTool will NOT select
  358.          a locked pen (which in this case is being located via "Pick")
  359.        - If you're using a commodity which traps the middle-mouse-button,
  360.          PaletteTool may not "see" this button press.  You can always use
  361.          the space bar in this instance.
  362. 11) @{"Cycle" beep 0} Button
  363.     Starts/stops the cycling of the pen colors in the current palette.
  364.     Press once to start cycling.  Press again to stop cycling.
  365.     See the "Protect/Free" palette mode discussion (#8) above for important
  366.     info relative to "Cycle".
  367.     Note that all non-cycle-related sliders/buttons/etc. are disabled
  368.     while cycling is in progress.
  369. 12) @{"Fwd/Rev" beep 0} Cycle Gadget
  370.     Controls the direction of the color cycling. 
  371.        Fwd  =  Forward Cycle
  372.        Rev  =  Reverse Cycle
  373.     Note that the cycle-direction control is ACTIVE during cycling 
  374.     (i.e., you can change directions while you are cycling).
  375. 13) @{"Spd" beep 0} Slider
  376.     Control the speed of the color cycling.
  377.     Values range from 1 (= slowest) to 20 (= fastest).
  378.     Note that the cycle speed control is ACTIVE during cycling (i.e., you
  379.     can change speeds which you are cycling).
  380. 14) @{"<" beep 0} and @{">" beep 0} Buttons
  381.     Incrementally shift the palette in either the left (<) or right (>)
  382.     direction.
  383.     Key equivalent for "shift left" is either "<" or the cursor-left
  384.     (arrow) key.
  385.     Key equivalent for "shift right" is either ">" or the cursor-right
  386.     (arrow) key.
  387. 14) @{"Reset" beep 0} Button
  388.     Key equivalent is either "r" or "R".
  389.     Restores the screen palette to where it was when PaletteTool was
  390.     started.
  391. 15) @{"I" beep 0} Button
  392.     Iconify.
  393.     Closes all PaletteTool windows and opens into a single small window
  394.     (known as the "iconified" window).
  395.     Color cycling is available from this "iconified" window, using the
  396.     same cycling controls as specified above.
  397.     Pressing the Open button in the "iconified" window will reopen the
  398.     PaletteTool window(s) 
  399. 16) @{"?" beep 0} Button
  400.     About the program/author.
  401.     Opens an info requestor.
  402. @endnode
  403. @node palettewindowdescription "Palette Window Description"
  404. The current screen palette (pen color display) is displayed in a
  405. separate window (named "Palette").
  406. The opened/closed state and size (Sm/Lg) of the Palette window is 
  407. controlled via the main PaletteTool window.
  408. Within the Palette window, you can optionally select (using the
  409. pointer and the left-mouse-button):
  410.    - the pen to be modified by the Red/Grn/Blu sliders
  411.    - the pens associated with copy, spread, and exchange actions
  412.    - the pen whose color is to be "flashed" by the "Show" button
  413. The currently selected pen is recessed within the palette display.
  414. The Palette window can be positioned independently of the main
  415. PaletteTool window.  The location of the Palette window will also
  416. be restored upon un-iconifying.
  417. However, when the Palette window is closed using the "Palette"
  418. button, it will re-open immediately adjacent to the main PaletteTool
  419. window.
  420. Both the "Small" and "Large" palette displays are fixed in size.
  421. Therefore, the displayed size of each pen's color in the palette 
  422. decreases as the number of screen pens increases (AKA screen depth).
  423. The pens are displayed in "row sequential form" from left-to-right and 
  424. top-to-bottom.
  425. Therefore, the first row in the palette display consists of pens 0, 1, 2, 
  426. 3, 4, etc.
  427. I was working on a resizable palette display window, but Commodore's
  428. GadTools library does not support a resizable palette gadget.  This
  429. means I would have to do a window close/re-open when the user resized
  430. the palette window.  After experimenting with this, I decided I didn't
  431. like the way it worked (I hate "working around" things), so I abandoned
  432. that method.
  433. @endnode
  434. @node cbnwindowdescription "ColorByName Window Description"
  435. The ColorByName window is where you can choose RGB values for
  436. the currently selected pen by simply left-clicking on one of the
  437. names in the scrolling list.
  438. The opened/closed state of this separate window is controlled via
  439. the main PaletteTool window.
  440. The ColorByName window can be positioned independently of the main
  441. PaletteTool window.  The location of the ColorByName window will also
  442. be restored upon un-iconifying.
  443. However, when the ColorByName window is closed using the "ColorByName"
  444. button, it will re-open immediately adjacent to the main PaletteTool
  445. window.
  446. @endnode
  447. @node iconwindowdescription "Iconified Window Description"
  448. The iconified PaletteTool window replaces the other PaletteTool
  449. window(s) when you select the "I" button on the main window.
  450. The full set of palette cycling controls are available from this
  451. iconified window.  The controls perform identically to those on
  452. the main PaletteTool window.
  453. The last location of the iconified PaletteTool window will be 
  454. restored when you re-iconify.
  455. @endnode
  456. @node basicptoperation "Basic PaletteTool Operation"
  457. You select a pen for modification (or just viewing) by left-clicking
  458. on one of the colors in the palette display. 
  459. This becomes the "active" pen.
  460. The "currently selected pen's color" box on the middle-right side of the 
  461. window will change to show you the color associated with the pen you just 
  462. picked.
  463. Once a color is selected, it's RGB components can be modified by using
  464. the three Red/Grn/Blu sliders.
  465. See the "... Window Description" section for specific guidelines.
  466. I intended PaletteTool to be somewhat intuitive in how it works, so I hope
  467. the lack of detailed directions is not an issue.
  468. If you have any specific questions on PaletteTool's operation which don't
  469. seem to be covered by this file, please contact me and I'll do my best
  470. to help you out.
  471. @endnode
  472. @node icontooltypes "Icon Tooltypes"
  473. PaletteTool recognizes the following Tooltypes within it's icon:
  474. X=<number>    -    The X-coordinate at which the PaletteTool main
  475.                     window will initially open.
  476. Y=<number>    -    The Y-coordinate at which the PaletteTool main
  477.                     window will initially open.
  478. If these tooltypes are not present, the PaletteTool main window will
  479. open at coordinates X=10 Y=10.
  480. @endnode
  481. @node credits "Credits"
  482. The GUI for PaletteTool was developed using Jan van den Baards'
  483. wonderful GadToolsBox.
  484. Thanks to the KreuzerSoft support team.
  485. Thanks to the Nations Capital Amiga Users Group (NCUAG).
  486. Major thanks to Dave at Buried Treasure in Rockville, MD.
  487. *********************************************************************
  488. * Please patronize your local Amiga dealers (like Dave), everyone. **
  489. *                                                                  **
  490. * Most of these people are NOT making tons of $$$$, so if you'd    **
  491. * like to keep a local presence in your area, GO BUY SOMETHING!    **
  492. *********************************************************************
  493. Thanks to Commodore for the Amiga, and to Jan van den Baard for making
  494. the development of GUI's on the Amiga child's play.
  495. Thanks to Commodore for (finally) releasing the 3.0 Includes and Libraries!
  496. Thanks to Randy Thompson and Rhett Andersone for "Mapping the Amiga/
  497. Second Edition".  Finally, some type of 3.0 "C" book!
  498. @endnode
  499. @node contactingtheauthor "Contacting the Author"
  500. I'd really like to hear any feedback you have regarding PaletteTool.
  501. I can be reached via any of the following methods:
  502.    - tkreuzer@delphi.com on the Internet
  503.    - T.KREUZER on GEnie
  504.    - via regular mail at: 6711A N. Washington Blvd.
  505.                       Arlington, VA  22213
  506. @endnode
  507. @node legalstuff "Legal Stuff"
  508. PaletteTool Version 1.4
  509. Copyright 
  510. 1994 by Timothy B. Kreuzer.  All rights reserved.
  511. You are hereby granted the freedom to distribute PaletteTool IF, AND ONLY
  512. IF the following rules are followed:
  513.         - This doc file MUST be kept with the executable(s), and must
  514.           include the above copyright notice.
  515.         - You may NOT charge ANY fee for this program, other than the basic
  516.           cost of distribution media and/or BBS access.  Of course if
  517.           you want to pursue selling this, feel free drop me a line.
  518. Fred Fish is hereby granted permission to include this program (and it's
  519. accompanying documentation) in his excellent collection of Amiga software.
  520. @endnode
  521. @node kreuzersoftproducts "KreuzerSoft Products"
  522. The following KreuzerSoft projects are (hopefully) available on a BBS
  523. near you:
  524.         PST V1.0a          - Public Screen utility for 3.0/AGA
  525.         Fractal V1.2       - Mandelbrot set program for 3.0/AGA
  526.         LyapunovSpace V1.2 - Lyapunov fractal program for 3.0/AGA
  527.         Terrain V1.1       - 3-D fractal terrain program for 3.0/AGA
  528.         FindColor V1.0a    - "Color-by-Name" selector for 3.0/AGA
  529.         Worm V1.1          - Port of SUN-Unix graphic toy for all Amigas
  530.         DLA                - Diffusion Limited Aggregation simulation for
  531.                              all Amigas
  532.         Jimi               - 8-color Jimi Hendrix image for your Workbench.
  533.         MemTool            - Memory monitor tool for the Workbench
  534.         Reminder V1.1      - Timed reminder tool for the Workbench
  535. All for the incredibly low, low price of FREE!          
  536. @endnode
  537.